Node / meshtastic / Meshtastic-Android / files / core / network / src / commonTest / kotlin / org / meshtastic / core / network / radio / BleRadioTransportTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2025-2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.network.radio

Tff7b72import T7ee787dev.mokkery.MockMode

Tff7b72import T7ee787dev.mokkery.answering.returns

Tff7b72import T7ee787dev.mokkery.every

Tff7b72import T7ee787dev.mokkery.matcher.any

Tff7b72import T7ee787dev.mokkery.mock

Tff7b72import T7ee787dev.mokkery.verify

Tff7b72import T7ee787dev.mokkery.verify.VerifyMode

Tff7b72import T7ee787kotlinx.coroutines.ExperimentalCoroutinesApi

Tff7b72import T7ee787kotlinx.coroutines.test.TestScope

Tff7b72import T7ee787kotlinx.coroutines.test.advanceTimeBy

Tff7b72import T7ee787kotlinx.coroutines.test.runTest

Tff7b72import T7ee787org.meshtastic.core.model.RadioNotConnectedException

Tff7b72import T7ee787org.meshtastic.core.repository.RadioInterfaceService

Tff7b72import T7ee787org.meshtastic.core.testing.FakeBleConnection

Tff7b72import T7ee787org.meshtastic.core.testing.FakeBleConnectionFactory

Tff7b72import T7ee787org.meshtastic.core.testing.FakeBleDevice

Tff7b72import T7ee787org.meshtastic.core.testing.FakeBleScanner

Tff7b72import T7ee787org.meshtastic.core.testing.FakeBluetoothRepository

Tff7b72import T7ee787kotlin.test.BeforeTest

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalCoroutinesApiTff7b72::Te6edf3classTb4b4b4)

Tff7b72class T56d364BleRadioTransportTest Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3testScope Tff7b72= Te6edf3TestScopeTb4b4b4(Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3scanner Tff7b72= Te6edf3FakeBleScannerTb4b4b4(Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3bluetoothRepository Tff7b72= Te6edf3FakeBluetoothRepositoryTb4b4b4(Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3connection Tff7b72= Te6edf3FakeBleConnectionTb4b4b4(Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3connectionFactory Tff7b72= Te6edf3FakeBleConnectionFactoryTb4b4b4(Te6edf3connectionTb4b4b4)

Tff7b72private Tff7b72val Te6edf3serviceTb4b4b4: Te6edf3RadioInterfaceService Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4)

Tff7b72private Tff7b72val Te6edf3address Tff7b72= Ta5d6ff"Ta5d6ff00:11:22:33:44:55Ta5d6ff"

Tf0883e@BeforeTest

Tff7b72fun Td2a8ffsetupTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3bluetoothRepositoryTb4b4b4.Te6edf3setHasPermissionsTb4b4b4(Tff7b72trueTb4b4b4)

Te6edf3bluetoothRepositoryTb4b4b4.Te6edf3setBluetoothEnabledTb4b4b4(Tff7b72trueTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`connect attempts to scan and connect via start`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3device Tff7b72= Te6edf3FakeBleDeviceTb4b4b4(Te6edf3address Tff7b72= Te6edf3addressTb4b4b4, Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffTest DeviceTa5d6ff"Tb4b4b4)

Te6edf3scannerTb4b4b4.Te6edf3emitDeviceTb4b4b4(Te6edf3deviceTb4b4b4)

Tff7b72val Te6edf3bleTransport Tff7b72=

Te6edf3BleRadioTransportTb4b4b4(

Te6edf3scope Tff7b72= Te6edf3testScopeTb4b4b4,

Te6edf3scanner Tff7b72= Te6edf3scannerTb4b4b4,

Te6edf3bluetoothRepository Tff7b72= Te6edf3bluetoothRepositoryTb4b4b4,

Te6edf3connectionFactory Tff7b72= Te6edf3connectionFactoryTb4b4b4,

Te6edf3callback Tff7b72= Te6edf3serviceTb4b4b4,

Te6edf3address Tff7b72= Te6edf3addressTb4b4b4,

Tb4b4b4)

Te6edf3bleTransportTb4b4b4.Te6edf3startTb4b4b4(Tb4b4b4)

T8b949e// start() begins connect() which is async

T8b949e// In a real test we'd verify the connection state,

T8b949e// but for now this confirms it works with the fakes.

Te6edf3assertEqualsTb4b4b4(Te6edf3addressTb4b4b4, Te6edf3bleTransportTb4b4b4.Te6edf3addressTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`address returns correct value`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3bleTransport Tff7b72=

Te6edf3BleRadioTransportTb4b4b4(

Te6edf3scope Tff7b72= Te6edf3testScopeTb4b4b4,

Te6edf3scanner Tff7b72= Te6edf3scannerTb4b4b4,

Te6edf3bluetoothRepository Tff7b72= Te6edf3bluetoothRepositoryTb4b4b4,

Te6edf3connectionFactory Tff7b72= Te6edf3connectionFactoryTb4b4b4,

Te6edf3callback Tff7b72= Te6edf3serviceTb4b4b4,

Te6edf3address Tff7b72= Te6edf3addressTb4b4b4,

Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3addressTb4b4b4, Te6edf3bleTransportTb4b4b4.Te6edf3addressTb4b4b4)

Tb4b4b4}

T8b949e/**

* After [BleReconnectPolicy.DEFAULT_FAILURE_THRESHOLD] consecutive connection failures,

* [RadioInterfaceService.onDisconnect] must be called so the higher layers can react (e.g. start the device-sleep

* timeout in [MeshConnectionManagerImpl]).

*

* Virtual-time breakdown (DEFAULT_FAILURE_THRESHOLD = 3, DEFAULT_SETTLE_DELAY = 3 s): t = 3 000 ms — iteration 1

* settle delay elapses, connectAndAwait throws, backoff 5 s starts t = 8 000 ms — backoff ends t = 11 000 ms —

* iteration 2 settle delay elapses, connectAndAwait throws, backoff 10 s starts t = 21 000 ms — backoff ends t = 24

* 000 ms — iteration 3 settle delay elapses, connectAndAwait throws → onDisconnect called

*/

Tf0883e@Test

Tff7b72fun Td2a8ff`onDisconnect is called after DEFAULT_FAILURE_THRESHOLD consecutive failures`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3device Tff7b72= Te6edf3FakeBleDeviceTb4b4b4(Te6edf3address Tff7b72= Te6edf3addressTb4b4b4, Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffTest DeviceTa5d6ff"Tb4b4b4)

Te6edf3bluetoothRepositoryTb4b4b4.Te6edf3bondTb4b4b4(Te6edf3deviceTb4b4b4) T8b949e// skip BLE scan — device is already bonded

T8b949e// Make every connectAndAwait call throw so each iteration counts as one failure.

Te6edf3connectionTb4b4b4.Te6edf3connectException Tff7b72= Te6edf3RadioNotConnectedExceptionTb4b4b4(Ta5d6ff"Ta5d6ffsimulated failureTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3bleTransport Tff7b72=

Te6edf3BleRadioTransportTb4b4b4(

Te6edf3scope Tff7b72= Tff7b72thisTb4b4b4,

Te6edf3scanner Tff7b72= Te6edf3scannerTb4b4b4,

Te6edf3bluetoothRepository Tff7b72= Te6edf3bluetoothRepositoryTb4b4b4,

Te6edf3connectionFactory Tff7b72= Te6edf3connectionFactoryTb4b4b4,

Te6edf3callback Tff7b72= Te6edf3serviceTb4b4b4,

Te6edf3address Tff7b72= Te6edf3addressTb4b4b4,

Tb4b4b4)

Te6edf3bleTransportTb4b4b4.Te6edf3startTb4b4b4(Tb4b4b4)

T8b949e// Advance through exactly 3 failure iterations (≈24 001 ms virtual time).

T8b949e// The 4th iteration's backoff hasn't elapsed yet, so the coroutine is suspended

T8b949e// and advanceTimeBy returns cleanly.

Te6edf3advanceTimeByTb4b4b4(T79c0ff2T79c0ff4Te6edf3_001LTb4b4b4)

Te6edf3verify Tb4b4b4{ Te6edf3serviceTb4b4b4.Te6edf3onDisconnectTb4b4b4(Te6edf3anyTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3anyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4}

T8b949e// Cancel the reconnect loop so runTest can complete.

Te6edf3bleTransportTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e/**

* Reconnect policy must NEVER give up on its own. The transport is only ever instantiated for the user-selected

* device, and explicit-disconnect is owned by the service layer (close()). Even after a sustained failure storm —

* well beyond the legacy [BleReconnectPolicy.DEFAULT_MAX_FAILURES] — the transport must keep retrying and must

* never call `onDisconnect(isPermanent = true)` from the give-up path.

*

* Time budget for 15 failures with bonded device (no scan): each iteration ≈ 3 s settle + immediate throw +

* backoff. Backoffs cap at 60 s after failure 5: 5+10+20+40+60+60+60+60+60+60+60+60+60+60+60 = 735 s, plus 15×3 s

* settle = 45 s, total ≈ 780 s. Use 800_000 ms to cover variance.

*/

Tf0883e@Test

Tff7b72fun Td2a8ff`reconnect loop never gives up - no permanent disconnect from policy`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3device Tff7b72= Te6edf3FakeBleDeviceTb4b4b4(Te6edf3address Tff7b72= Te6edf3addressTb4b4b4, Te6edf3name Tff7b72= Ta5d6ff"Ta5d6ffTest DeviceTa5d6ff"Tb4b4b4)

Te6edf3bluetoothRepositoryTb4b4b4.Te6edf3bondTb4b4b4(Te6edf3deviceTb4b4b4)

Te6edf3connectionTb4b4b4.Te6edf3connectException Tff7b72= Te6edf3RadioNotConnectedExceptionTb4b4b4(Ta5d6ff"Ta5d6ffsimulated failureTa5d6ff"Tb4b4b4)

Te6edf3every Tb4b4b4{ Te6edf3serviceTb4b4b4.Te6edf3onDisconnectTb4b4b4(Te6edf3anyTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3anyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4} Te6edf3returns Tffa657Unit

Tff7b72val Te6edf3bleTransport Tff7b72=

Te6edf3BleRadioTransportTb4b4b4(

Te6edf3scope Tff7b72= Tff7b72thisTb4b4b4,

Te6edf3scanner Tff7b72= Te6edf3scannerTb4b4b4,

Te6edf3bluetoothRepository Tff7b72= Te6edf3bluetoothRepositoryTb4b4b4,

Te6edf3connectionFactory Tff7b72= Te6edf3connectionFactoryTb4b4b4,

Te6edf3callback Tff7b72= Te6edf3serviceTb4b4b4,

Te6edf3address Tff7b72= Te6edf3addressTb4b4b4,

Tb4b4b4)

Te6edf3bleTransportTb4b4b4.Te6edf3startTb4b4b4(Tb4b4b4)

T8b949e// Run well past where the legacy policy (maxFailures = 10) would have given up.

Te6edf3advanceTimeByTb4b4b4(T79c0ff8T79c0ff0T79c0ff0Te6edf3_001LTb4b4b4)

T8b949e// Transient disconnects (isPermanent = false) are expected once the failure threshold is hit;

T8b949e// the policy must NEVER signal a permanent disconnect on its own. Only explicit close()

T8b949e// (verified separately by the service layer) may emit isPermanent = true.

Te6edf3verifyTb4b4b4(Te6edf3mode Tff7b72= Te6edf3VerifyModeTb4b4b4.Te6edf3notTb4b4b4) Tb4b4b4{ Te6edf3serviceTb4b4b4.Te6edf3onDisconnectTb4b4b4(Te6edf3isPermanent Tff7b72= Tff7b72trueTb4b4b4, Te6edf3errorMessage Tff7b72= Te6edf3anyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4}

Te6edf3bleTransportTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tb4b4b4}